Mostly missing (transfer none).
* display has previously been set, simply returns that. An internal
* function that should not be used by applications.
*
- * Return value: the default display, if it could be opened,
- * otherwise %NULL.
+ * Return value: (transfer none): the default display, if it could be
+ * opened, otherwise %NULL.
**/
GdkDisplay *
gdk_display_open_default_libgtk_only (void)
*
* Returns the #GdkDisplay to which @device pertains.
*
- * Returns: a #GdkDisplay. This memory is owned by GTK+,
- * and must not be freed or unreffed.
+ * Returns: (transfer none): a #GdkDisplay. This memory is owned
+ * by GTK+, and must not be freed or unreffed.
*
* Since: 3.0
**/
* If @device is of type %GDK_DEVICE_TYPE_FLOATING, %NULL will be
* returned, as there is no associated device.
*
- * Returns: The associated device, or %NULL
+ * Returns: (transfer none): The associated device, or %NULL
*
* Since: 3.0
**/
*
* Gets the #GdkDisplay associated to @device_manager.
*
- * Returns: the #GdkDisplay to which @device_manager is
- * associated to, or #NULL.
+ * Returns: (transfer none): the #GdkDisplay to which @device_manager is
+ * associated to, or #NULL. This memory is owned by GDK and
+ * must not be freed or unreferenced.
*
* Since: 3.0
**/
* You should use this function sheldomly, only in code that isn't triggered by a #GdkEvent
* and there aren't other means to get a meaningful #GdkDevice to operate on.
*
- * Returns: The client pointer.
+ * Returns: (transfer none): The client pointer. This memory is
+ * owned by GDK and must not be freed or unreferenced.
*
* Since: 3.0
**/
*
* Returns the core pointer device for the default display.
*
- * Return value: the core pointer device; this is owned by the
- * display and should not be freed.
+ * Return value: (transfer none): the core pointer device; this is owned
+ * by the display and should not be freed.
*
* Deprecated: 3.0: Use gdk_device_manager_get_client_pointer() instead, or
* gdk_event_get_device() if a #GdkEvent with pointer device
*
* Returns the core pointer device for the given display
*
- * Return value: the core pointer device; this is owned by the
+ * Return value: (transfer none): the core pointer device; this is owned by the
* display and should not be freed.
*
* Since: 2.2
* Obtains the window underneath @device, returning the location of the device in @win_x and @win_y. Returns
* %NULL if the window tree under @device is not known to GDK (for example, belongs to another application).
*
- * Returns: the #GdkWindow under the device position, or %NULL.
+ * Returns: (transfer none): the #GdkWindow under the device position, or %NULL.
*
* Since: 3.0
**/
* #GdkDevice on a particular #GdkDisplay. This is only useful for such low-level tools as
* an event recorder. Applications should never have any reason to use this facility.
*
- * Returns: The previous device hook table.
+ * Returns: (transfer none): The previous device hook table.
*
* Since: 3.0
**/
* event recorder. Applications should never have any
* reason to use this facility.
*
- * Return value: the previous pointer hook table
+ * Return value: (transfer none): the previous pointer hook table
*
* Since: 2.2
*
*
* Returns the #GdkDeviceManager associated to @display.
*
- * Returns: A #GdkDeviceManager, or %NULL. This memory is
+ * Returns: (transfer none): A #GdkDeviceManager, or %NULL. This memory is
* owned by GDK and must not be freed or unreferenced.
*
* Since: 3.0
* to which <literal>event->motion.x_root</literal> and
* <literal>event->motion.y_root</literal> are relative.
*
- * Return value: the screen for the event
+ * Return value: (transfer none): the screen for the event
*
* Since: 2.2
**/
*
* Returns the #GdkKeymap attached to the default display.
*
- * Returns: the #GdkKeymap attached to the default display.
+ * Returns: (transfer none): the #GdkKeymap attached to the default display.
*/
GdkKeymap*
gdk_keymap_get_default (void)
*
* Gets the window that @window is embedded in.
*
- * Returns: the embedding #GdkWindow, or %NULL if @window is not an
- * embedded offscreen window
+ * Returns: (transfer none): the embedding #GdkWindow, or %NULL
+ * if @window is not an mbedded offscreen window
*
* Since: 2.18
*/
* is more convenient if you want to keep a context around and track
* changes to the screen's font rendering settings.
*
- * Return value: a new #PangoContext for the default display
+ * Return value: (transfer full): a new #PangoContext for the default display
**/
PangoContext *
gdk_pango_context_get (void)
* is more convenient if you want to keep a context around and track
* changes to the screen's font rendering settings.
*
- * Return value: a new #PangoContext for @screen
+ * Return value: (transfer full): a new #PangoContext for @screen
*
* Since: 2.2
**/
*
* Determines the owner of the given selection.
*
- * Returns: if there is a selection owner for this window,
- * and it is a window known to the current process,
- * the #GdkWindow that owns the selection, otherwise
+ * Returns: (transfer none): if there is a selection owner for
+ * this window, and it is a window known to the current
+ * process, the #GdkWindow that owns the selection, otherwise
* %NULL. Note that the return value may be owned
* by a different process if a foreign window
* was previously created for that window, but
*
* Gets the #GdkVisual describing the pixel format of @window.
*
- * Return value: a #GdkVisual
+ * Return value: (transfer none): a #GdkVisual
*
* Since: 2.24
**/
*
* Gets the #GdkScreen associated with a #GdkWindow.
*
- * Return value: the #GdkScreen associated with @window
+ * Return value: (transfer none): the #GdkScreen associated with @window
*
* Since: 2.24
**/
*
* Gets the #GdkDisplay associated with a #GdkWindow.
*
- * Return value: the #GdkDisplay associated with @window
+ * Return value: (transfer none): the #GdkDisplay associated with @window
*
* Since: 2.24
**/
* Obtains the root window (parent all other windows are inside)
* for the default display and screen.
*
- * Return value: the default root window
+ * Return value: (transfer none): the default root window
**/
GdkWindow *
gdk_get_default_root_window (void)
* For example in the X backend, a native window handle is an Xlib
* <type>XID</type>.
*
- * Return value: the newly-created #GdkWindow wrapper for the
- * native window or %NULL if the window has been destroyed.
+ * Return value: (transfer full): the newly-created #GdkWindow wrapper
+ * for the native window, or %NULL if the window has been destroyed.
**/
GdkWindow *
gdk_window_foreign_new (GdkNativeWindow anid)
*
* Returns the display on which the #GdkCursor is defined.
*
- * Returns: the #GdkDisplay associated to @cursor
+ * Returns: (transfer none): the #GdkDisplay associated to @cursor
*
* Since: 2.2
*/
* on the cursor, GDK may not be able to obtain the image data. In this
* case, %NULL is returned.
*
- * Returns: a #GdkPixbuf representing @cursor, or %NULL
+ * Returns: (transfer full): a #GdkPixbuf representing @cursor, or %NULL
*
* Since: 2.8
*/
/**
* gdk_display_open:
* @display_name: the name of the display to open
- * @returns: a #GdkDisplay, or %NULL if the display
- * could not be opened.
*
* Opens a display.
*
+ * Return value: (transfer none): a #GdkDisplay, or %NULL if the display
+ * could not be opened.
+ *
* Since: 2.2
*/
GdkDisplay *
*
* Returns a screen object for one of the screens of the display.
*
- * Returns: the #GdkScreen object
+ * Returns: (transfer none): the #GdkScreen object
*
* Since: 2.2
*/
*
* Get the default #GdkScreen for @display.
*
- * Returns: the default #GdkScreen object for @display
+ * Returns: (transfer none): the default #GdkScreen object for @display
*
* Since: 2.2
*/
* on @display. This window is implicitly created by GDK.
* See gdk_window_set_group().
*
- * Return value: The default group leader window for @display
+ * Return value: (transfer none): The default group leader window
+ * for @display
*
* Since: 2.4
**/
*
* Find the #GdkDisplay corresponding to @display, if any exists.
*
- * Return value: the #GdkDisplay, if found, otherwise %NULL.
+ * Return value: (transfer none): the #GdkDisplay, if found, otherwise %NULL.
*
* Since: 2.2
**/
*
* Returns the #GdkDevice associated to the drag context.
*
- * Returns: The #GdkDevice associated to @context.
+ * Returns: (transfer none): The #GdkDevice associated to @context.
**/
GdkDevice *
gdk_drag_context_get_device (GdkDragContext *context)
*
* This function is called by the drag source.
*
- * Return value: a newly created #GdkDragContext.
+ * Return value: (transfer full): a newly created #GdkDragContext.
**/
GdkDragContext *
gdk_drag_begin (GdkWindow *window,
/**
* gdk_keymap_get_for_display:
* @display: the #GdkDisplay.
- * @returns: the #GdkKeymap attached to @display.
*
* Returns the #GdkKeymap attached to @display.
*
+ * Return value: (transfer none): the #GdkKeymap attached to @display.
+ *
* Since: 2.2
**/
GdkKeymap*
*
* Gets the display to which the @screen belongs.
*
- * Returns: the display to which @screen belongs
+ * Returns: (transfer none): the display to which @screen belongs
*
* Since: 2.2
**/
}
/**
- * gdk_screen_get_active_window
+ * gdk_screen_get_active_window:
* @screen: a #GdkScreen
*
* Returns the screen's currently active window.
* The returned window should be unrefed using g_object_unref() when
* no longer needed.
*
- * Return value: the currently active window, or %NULL.
+ * Return value: (transfer full): the currently active window, or %NULL.
*
* Since: 2.10
**/
* process if a foreign window was previously created for that
* window, but a new foreign window will never be created by this call.
*
- * Returns: if there is a selection owner for this window, and it is a
- * window known to the current process, the #GdkWindow that owns the
- * selection, otherwise %NULL.
+ * Returns: (transfer none): if there is a selection owner for this window,
+ * and it is a window known to the current process, the #GdkWindow that
+ * owns the selection, otherwise %NULL.
*
* Since: 2.2
*/
* For example in the X backend, a native window handle is an Xlib
* <type>XID</type>.
*
- * Return value: a #GdkWindow wrapper for the native window or
- * %NULL if the window has been destroyed. The wrapper will be
- * newly created, if one doesn't exist already.
+ * Return value: (transfer full): a #GdkWindow wrapper for the native
+ * window, or %NULL if the window has been destroyed. The wrapper
+ * will be newly created, if one doesn't exist already.
*
* Since: 2.2
**/
* For example in the X backend, a native window handle is an Xlib
* <type>XID</type>.
*
- * Return value: the #GdkWindow wrapper for the native window,
- * or %NULL if there is none.
+ * Return value: (transfer none): the #GdkWindow wrapper for the native
+ * window, or %NULL if there is none.
*
* Since: 2.2
**/
* For example in the X backend, a native window handle is an Xlib
* <type>XID</type>.
*
- * Return value: the #GdkWindow wrapper for the native window,
- * or %NULL if there is none.
+ * Return value: (transfer none): the #GdkWindow wrapper for the native
+ * window, or %NULL if there is none.
**/
GdkWindow *
gdk_window_lookup (GdkNativeWindow anid)
*
* Returns the GDK object associated with the given X id.
*
- * Return value: the associated #GdkWindow or %NULL if no
- * object is associated with the X id.
+ * Return value: (transfer none): the associated #GdkWindow, or %NULL
+ * of no object is associated with the X id.
*
* Since: 2.2
*/
* Returns the Gdk object associated with the given X id for the default
* display.
*
- * Return value: the associated #GdkWindow or %NULL if no
- * object is associated with the X id.
+ * Return value: (transfer none): the associated #GdkWindow, or %NULL
+ * if no object is associated with the X id.
*/
gpointer
gdk_xid_table_lookup (XID xid)
projects / gtk4.git / commitdiff